home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / domenu13.zip / READ.ME < prev    next >
Text File  |  1991-11-12  |  4KB  |  100 lines
  1. DOMENUT -- Version 1.3 (note, this program replaces both DOMENUT 
  2.            and DOMENU).
  3.  
  4. READ.ME        This file
  5. SHOWM.BAT    A sample batch file
  6. SHOWM.MNU    A sample menu
  7. DOMENUT.EXE    The program
  8. SHOWDO1.BAT    A sample batch file with some options set
  9. SHOWM.MNU    The menu for SHOWM.BAT
  10.  
  11.      DOMENUT is a menuing system for batch files.   It  opens  a 
  12. menu  as  a  window,  accepts  the  menu  entry,  and returns an 
  13. errorlevel for batch to take action on.  To try it out, run  the 
  14. batch file SHOWM.  It uses DOMENUT with the menu "SHOWM.MNU".
  15.  
  16.     Menu  files  may  be  any text file of up to 14 lines.  Each 
  17. line is limited to 60 characters.  There is no need  to  justify 
  18. or  center,  DOMENUT  will  count  both lines and characters per 
  19. line, then arrange everything neatly.
  20.  
  21. NOTE: THE BATCH  "IF  ERRORLEVEL"  STATEMENT  IS  REALLY  A  "IF 
  22.       ERRORLEVEL  > n" COMMAND. THIS MAKES IT NECCESSARY TO TEST 
  23.       ERROR LEVELS FROM HIGHEST TO LOWEST. THE SAMPLE BATCH FILE 
  24.       SHOWS THIS.
  25.  
  26.     Several "special" lines can be put into  the  menu  file  to 
  27. modify  DOMENUT  actions.   These  command  lines to DOMENUT are 
  28. recognized by the fact that they start  with  a  period,  and  a 
  29. command letter.
  30.  
  31.     For example, any line starting with ".R" is considered to be 
  32. a remark, and is ignored.
  33.  
  34. SPECIAL COMMANDS:
  35.  
  36. .F n
  37.     The  ".F"  command  sets  the foreground colour to colour n.  
  38. The  colours  are  n=0=black,  n=1=blue,  n=2=green,   n=3=cyan, 
  39. n=4=red,   n=5=magenta,   n=6=brown,   n=7=white.    Programmers 
  40. familiar with colour programs will recognize the numbers; if you 
  41. do,  the  arguement  is  made  mod  16  and  used  as the screen 
  42. attribute.  So you can get blink, underline, etc., depending  on 
  43. your screen type.
  44.  
  45. .B  n
  46.     As above but background colour.  Background  and  foreground 
  47. are  a  bit  vaque  with  both of these commands, as half of the 
  48. window is reverse video, and half  is  not.   For  the  sake  of 
  49. arguement,  the  characters  of the box outlining the window are 
  50. considered foreground.  Probably backwards to  how  most  people 
  51. think (including me), but that is the way the macro bounced.
  52.  
  53. .S n
  54.     Set  timer for n seconds.  When the timer times out, exit as 
  55. if a return was entered.  The main reason for this command is to 
  56. give  you  an  option  for  autoexec.bat files.  You can set the 
  57. timer for 15 seconds, for example, and make the first menu  item 
  58. your  default  power  up.  This gives you 15 seconds to select a 
  59. different power up option. (note that ALL keystokes  will  reset 
  60. the  timer  back  to 15 seconds, so you do not have to make your 
  61. mind up quickly, as long as you keep hitting keys).  Very useful 
  62. for stuff that runs unattended.
  63.  
  64.     Typically, I make the first menu item a power fail recovery, 
  65. the second a fast startup that bypasses the  recovery,  and  the 
  66. third a DOS exit.
  67.  
  68. .T A sentence goes here
  69.     The title command replaces my company name (Upscale Software 
  70. Inc.) with your company name.  That is so you can put menus on a 
  71. customer's  computer,  and  make it look like you wrote the menu 
  72. program ... a courtesy to fellow programers.  I will ask,  as  a 
  73. return courtesy, that you not use this feature unless you do one 
  74. of the following:
  75.  
  76. 1.  - Publish as "freeware" one or more of your own programs.  I 
  77. expect that program to be some usefull item ... trivial games by 
  78. beginners  do  not count, as do not programs that are too flakey 
  79. to use professionally.  But little stuff does ...  the  type  of 
  80. thing that we all need, but is too small to be commercial.
  81.  
  82. 2. - Make a small donation to your favourite charity and send me 
  83. a note saying that you have done so.
  84.  
  85. 3. - Run a public BBS.
  86.  
  87. 4.  - Send me a courtesy copy of any software that you  publish, 
  88. or have written, for my own use, not to be re-sold.
  89.  
  90.     If none of the above are true, please use  the  program  for 
  91. nothing,  but  leave  the  company  name  on the screen.  I will 
  92. consider the advertising as the shareware fee.
  93.  
  94.          Donald L. Tees                Ex-Libris BBS
  95.          Upscale Software Inc.            Fido 1:221/192
  96.          Windrush Farm
  97.          RR 2, Wellesley, Ontario
  98.          Canada
  99.          N0B 2T0
  100.